Inside Macintosh: Programming With JManager /

Chapter 2 - JManager Reference / JManager Functions

Text Handling Functions /

JMNewTextRef

Creates a new text object.

OSStatus JMNewTextRef (
                     JMSessionRef session, 
                     JMTextRef* textRef, 
                     JMTextEncoding encoding, 
                     const void* charBuffer, 
                     UInt32 bufferLengthInBytes
                     );

session

The session in which you want to create the text object.

textRef

A pointer to a text object. on return, this parameter is the new text object.

encoding

The text encoding of the string to encapsulate in the text object. You can pass any text encoding specification defined by the Text Encoding Converter. See "Text Encoding Specifications" for more information.

charBuffer

The string to encapsulate in the text object.

bufferLengthInBytes

The length of the string.

function result

A result code; see "JManager Result Codes".

DISCUSSION

If you create a text object, it is your responsibility to dispose of it after use.

SEE ALSO

The JMDisposeTextRef function.

The JMGetTextBytes function.